home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 020a / grabb390.zip / CONVERT.DOC < prev    next >
Text File  |  1991-09-13  |  19KB  |  391 lines
  1.  
  2.  
  3.                      GR2GIF (tm)
  4.                                     GR2PCX (tm)
  5.                                                    GR2PIC (tm)
  6.  
  7.                                      *********
  8.  
  9.                       Graphics Conversion Utilities for use with
  10.                        the GRABBER (tm) Screen Capture Program
  11.  
  12.  
  13.                                    DOCUMENTATION
  14.                                  September 13, 1991
  15.  
  16.  
  17.                                  Copyright 1991 by
  18.  
  19.                                   Gerald A. Monroe
  20.                                    1241 Bunts Road
  21.                               Lakewood, Ohio 44107  U.S.A.
  22.  
  23.                             CompuServe Mail ID # 72321,1257
  24.  
  25.  
  26.           YOUR LICENSE TO USE THIS SOFTWARE
  27.           ----------------------------------
  28.  
  29.           GR2GIF.EXE, GR2PCX.EXE, GR2PIC.EXE and this documentation are
  30.           Copyright 1991 by Gerald A. Monroe.  All rights are reserved
  31.           except those expressly granted here.
  32.  
  33.           The programs GR2GIF, GR2PCX and GR2PIC, and this documentation file,
  34.           are distributed as an integral part of the GRABBER (tm) screen capture
  35.           package under the terms of a shareware license that is fully set forth
  36.           in the file GRABBER.DOC, which is the instruction manual for GRABBER
  37.           .EXE, the main program module in the package.
  38.  
  39.           The shareware license terms in the GRABBER.DOC file are incorporated
  40.           here by reference.  This license permits you to copy and distribute
  41.           the files GR2GIF.EXE, GR2PCX.EXE, GR2PIC.EXE and CONVERT.DOC (this
  42.           file) freely, provided that:  these files are always distributed
  43.           together with each other and with the GRABBER.EXE and GRABBER.DOC
  44.           files; none of the files is modified in any way; and no fee, premium
  45.           or donation of any kind is charged or requested for their distribu-
  46.           tion except as permitted on the terms described in the GRABBER.DOC
  47.           file.
  48.  
  49.           Continued use of the GR2GIF, GR2PCX or GR2PIC programs for more than
  50.           a 10-day trial period requires you to register your use of the soft-
  51.           ware with the author.  For more information about the benefits of
  52.           registration and how to go about registering, please refer to the
  53.           full licensing and ordering information in the GRABBER.DOC file.
  54.  
  55.  
  56.  
  57.           GR2GIF /GR2PCX /GR2PIC  Documentation                      Page 2 of 7
  58.  
  59.  
  60.  
  61.  
  62.           WHAT ARE GR2GIF, GR2PCX and GR2PIC?
  63.           ------------------------------------
  64.  
  65.           GR2GIF, GR2PCX and GR2PIC are companion utilities to the GRABBER
  66.           screen capture program.  You can use them to convert graphic images,
  67.           captured from your video display in the form of GRABBER "offspring"
  68.           files, into any of three widely recognized generic image formats
  69.           called GIF, PCX and PIC.
  70.  
  71.           In addition, if your computer has an EGA or VGA video graphics
  72.           adapter, the GR2PCX utility can also convert 80 x 25 text images
  73.           captured by GRABBER to the PCX graphic format.
  74.  
  75.           (If you are unfamiliar with how the GRABBER program works, or what a
  76.           GRABBER offspring file is, please consult the program manual GRABBER
  77.           .DOC before continuing.)
  78.  
  79.  
  80.  
  81.           ABOUT THIS DOCUMENTATION
  82.           -------------------------
  83.  
  84.           These three GRABBER companion utilities are described together in
  85.           this one document because, for the most part, each is operated
  86.           identically to the others.  The main difference between these
  87.           programs is the format of the files which they produce.
  88.  
  89.           For this reason, and for the sake of simplicity, the command examples
  90.           which are used in this document make use of the GR2GIF.EXE program
  91.           exclusively.  GR2GIF creates GIF files from GRABBER offspring files.
  92.           If you want to create a PCX file with GR2PCX, or a PIC file using
  93.           GR2PIC, then you can substitute the appropriate program name wherever
  94.           the examples below refer to GR2GIF.
  95.  
  96.           Instructions for using these programs are detailed below, beginning
  97.           on page 5.  Briefly, you tell GR2GIF/PCX/PIC the name of the GRABBER
  98.           offspring file you wish to convert, and (optionally) the name of the
  99.           file to which to save the GIF/PCX/PIC rendition of your original
  100.           offspring file.  The program then goes to work, extracting the binary
  101.           screen image information from the offspring file, encoding it in the
  102.           appropriate format, and saving the results to the second file.
  103.  
  104.  
  105.  
  106.           GR2GIF /GR2PCX /GR2PIC  Documentation                      Page 3 of 7
  107.  
  108.  
  109.  
  110.           THE "GIF" FILE FORMAT
  111.           ----------------------
  112.  
  113.           "GIF" is pronounced like "Jif," and it stands for "Graphic Interchange
  114.           Format."
  115.  
  116.           The GIF image format was developed by CompuServe, Inc., as a
  117.           generalized method of exchanging and displaying graphic images on
  118.           the widest possible variety of computer graphics hardware.  GIF is
  119.           probably the most widely accepted format for exchanging graphics
  120.           information among all makes and models of microcomputers, whether
  121.           IBM-compatible or not.  If there is a "standard," then GIF is it.
  122.           One of the reasons for the popularity of the GIF format is its
  123.           very effective data compression method.  Generally, there is no
  124.           other widely used file format which can compress a graphic image
  125.           into a smaller space than GIF can.
  126.  
  127.           The GIF format is supported extensively on the CompuServe Information
  128.           Service and many other on-line BBS services that make graphic images
  129.           available for downloading.  In addition to these on-line services,
  130.           however, there are several PC application programs which can employ
  131.           the GIF format.  These include word processing, desktop publishing,
  132.           and "paint" programs, as well as numerous picture viewing utilities.
  133.           Therefore, you can use GR2GIF to convert almost any graphic image
  134.           captured by GRABBER into GIF format, so that the image can be imported
  135.           into any word processing, desktop publishing, or paint program which
  136.           "understands" the GIF format.  If you want to find out whether a
  137.           particular application program you use can work with GIF files, and
  138.           therefore import the files created by GR2GIF, you should consult that
  139.           program's documentation or contact its publisher.
  140.  
  141.  
  142.           THE "PCX" FILE FORMAT
  143.           ----------------------
  144.  
  145.           The PCX image format was developed by Zsoft Corporation, which is the
  146.           publisher of the widely used graphics "paint" programs PC Paintbrush
  147.           and Publisher's Paintbrush.  Both of these programs use the PCX format
  148.           for storing and retrieving graphic images to and from disk files.
  149.           However, many other PC applications which involve graphic data, in
  150.           addition to the two Zsoft products mentioned, also employ the PCX
  151.           format.  These include other paint programs, word processors such as
  152.           WordPerfect Version 5.0 and above, desktop publishing programs, and
  153.           picture viewing utilities.  The PCX format uses a data compression
  154.           scheme to reduce the disk space required to store graphic images.
  155.           You can use GR2PCX to convert almost any graphic image captured by
  156.           GRABBER into PCX format, so that the image can be imported into any
  157.           word processing, desktop publishing, or paint program which "under-
  158.           stands" the PCX format.  If you want to find out whether a particular
  159.           application program you use can work with PCX files, and therefore
  160.           import the files created by GR2PCX, you should consult that program's
  161.           documentation or contact its publisher.
  162.  
  163.  
  164.  
  165.           GR2GIF /GR2PCX /GR2PIC  Documentation                      Page 4 of 7
  166.  
  167.  
  168.  
  169.           THE "PIC" FILE FORMAT
  170.           ----------------------
  171.  
  172.           The PIC image format resembles the PCX format in its origins as a
  173.           method of storing "paint" program images.  The PIC format is employed
  174.           by such programs as EGA Paint, PC Paint and PC Paint Plus, and the
  175.           PICTOR and GRASP programs, as well as other paint programs.  Like GIF
  176.           and PCX, the PIC format uses a unique data compression scheme to save
  177.           disk space.  You can use GR2PIC to convert almost any graphic image
  178.           captured by GRABBER into the PIC format, so that the image can be
  179.           imported into any word processing, desktop publishing, or paint
  180.           program which "understands" the PIC format.  If you want to find out
  181.           whether a particular application program you use can work with PIC
  182.           files, you should consult that program's documentation or contact its
  183.           publisher.
  184.  
  185.  
  186.           WHAT GR2GIF/PCX/PIC CAN CONVERT
  187.           --------------------------------
  188.  
  189.           These programs are able to convert almost any GRABBER offspring file
  190.           containing a graphic image into a separate GIF, PCX or PIC file.
  191.           This includes any image originally captured in any CGA mode, any EGA
  192.           mode, any VGA mode, and the Hercules monochrome graphics mode.
  193.  
  194.           Also, the GR2PCX utility can be used to convert text-mode images to
  195.           the PCX graphics format.  To use GR2PCX to convert a text-mode image,
  196.           your computer must be equipped with an EGA or VGA video graphics
  197.           adapter, and the text screen must measure 80 columns by 25 rows.
  198.  
  199.           The GR2GIF and GR2PIC utilites cannot be used to convert text-mode
  200.           images to the GIF or PIC formats.
  201.  
  202.           On page 8 of the GRABBER program documentation, there is a list of
  203.           the various video modes which GRABBER supports.  If a video mode
  204.           in that chart indicates "n/a" in the column which is headed "Graphics
  205.           Resolution," then that is a text mode, and GRABBER offspring files
  206.           captured in that mode cannot be converted to GIF, PCX or PIC (with
  207.           the exception of modes 2, 3, and 7, which can be converted by GR2PCX).
  208.  
  209.           Note for technical users:  If you have a Super-VGA (SVGA) adapter, you
  210.           should read page 9 of the GRABBER program documentation.  Generally,
  211.           any 16-color or 256-color SVGA image can be converted to the GIF, PCX
  212.           and PIC formats using these programs if the SVGA manufacturer has
  213.           modeled the memory organization of its video modes after the IBM EGA
  214.           "four-plane planar" method (for 16-color screens), or IBM VGA "packed
  215.           pixel" method (for 256-color screens).  SVGA memory organization
  216.           schemes which are unique to certain adapters are generally not
  217.           supported by these conversion programs.  An example of such a mode is
  218.           the one numbered 65h for 1,024 x 768 16-color images on the ATI VGA
  219.           Wonder adapter.
  220.  
  221.  
  222.  
  223.           GR2GIF /GR2PCX /GR2PIC  Documentation                      Page 5 of 7
  224.  
  225.  
  226.           USING GR2GIF/PCX/PIC : INTERACTIVE MODE
  227.           ----------------------------------------
  228.  
  229.           First, choose a GRABBER offspring image you want to convert.  The
  230.           offspring file must contain a graphic image.
  231.  
  232.           From the DOS prompt (or in a batch file), enter the command GR2GIF
  233.           and press <RETURN>.  The program asks you to specify the name of the
  234.           offspring file you wish to convert (the "input file").  You may
  235.           optionally precede the filename with a drive and/or pathname if
  236.           necessary.
  237.  
  238.           (Note:  All GRABBER offspring files should have the file extension
  239.           ".EXE", and these conversion programs assume that your input file
  240.           ends in ".EXE".  You may omit this extension when entering the
  241.           file name.  For example, entering "SCREENXX" is the same as enter-
  242.           ing "SCREENXX.EXE".)
  243.  
  244.           Next, the program asks for the name of the file you wish to create
  245.           from the offspring image (the "output file").  If you wish to give
  246.           your output file the same name as your input file but with a ".gif"
  247.           (or ".pcx" or ".pic") extension, just press <RETURN>.  If you wish
  248.           to give it a different name than the default which the program shows
  249.           you, or place it in a different drive or directory than your input
  250.           file, you must enter the full file specification, including drive,
  251.           path, and ".gif" extension.
  252.  
  253.           (NOTE:  Do not give the output file an ".EXE" or ".COM" extension.
  254.           GIF, PCX and PIC files are not executable programs like the original
  255.           offspring file, and attempting to execute them like one will certainly
  256.           "crash" your computer.)
  257.  
  258.           Finally, the program asks if you want to "resize" the image.  If you
  259.           respond by pressing <N> or <RETURN>, then the program will convert the
  260.           entire image to GIF, PCX or PIC format.  The resulting file will in-
  261.           clude image data for the entire screen as it appears on your display
  262.           when you execute the .EXE offspring file.
  263.  
  264.           If you don't want to convert the entire image to GIF, PCX or PIC
  265.           format, but wish to convert only a portion of it, then you should
  266.           respond to the "resize" prompt by pressing <Y>.  GR2GIF will display
  267.           the offspring image on your screen along with a highlighted "select
  268.           box," which you use to tell the program which rectangular portion of
  269.           the image to save to GIF, PCX or PIC format.  Instructions for moving
  270.           the select box around the screen, and changing its size or shape, can
  271.           be found below on page 6.
  272.  
  273.           After you respond to the "resize" prompt by pressing <N> or <RETURN>,
  274.           or finish resizing the image (if you pressed <Y>), the program goes
  275.           to work, creating your output file from the original offspring.  This
  276.           usually takes only a few seconds.  When the program is finished
  277.           creating your output file, it displays a message to this effect.  This
  278.           newly created GIF, PCX or PIC file is now ready for you to use.
  279.  
  280.  
  281.  
  282.           GR2GIF /GR2PCX /GR2PIC  Documentation                      Page 6 of 7
  283.  
  284.  
  285.  
  286.           USING THE RESIZE FEATURE:  CONTROLLING THE SELECT BOX
  287.           ------------------------------------------------------
  288.  
  289.           The following keys are available to you when using the resize feature
  290.           feature within GR2GIF, GR2PCX and GR2PIC:
  291.  
  292.           <Esc> . . . . . . . . . . . .  Abort the conversion process and exit.
  293.  
  294.           <Return>  . . . . . . . . . .  Accept the area enclosed by the select
  295.                                          box, and begin converting.
  296.  
  297.           <Left Arrow>
  298.           <Right Arrow>                  Move the select box in the indicated
  299.           <Up Arrow>                     direction without changing the shape
  300.           <Down Arrow>  . . . . . . . .  of the box.
  301.  
  302.           <Shift><Left Arrow> . . . . .  Shrink the box horizontally.
  303.  
  304.           <Shift><Right Arrow>  . . . .  Expand the box horizontally.
  305.  
  306.           <Shift><Up Arrow> . . . . . .  Shrink the box vertically.
  307.  
  308.           <Shift><Down Arrow> . . . . .  Expand the box vertically.
  309.  
  310.           <Insert>  . . . . . . . . . .  Toggle between coarse and fine incre-
  311.                                          ments for moving or reshaping the box.
  312.  
  313.           <Home>  . . . . . . . . . . .  Move the box to the upper left-hand
  314.                                          corner of the screen.
  315.  
  316.           <End> . . . . . . . . . . . .  Move the box to the lower left-hand
  317.                                          corner of the screen.
  318.  
  319.           <Ctrl><PgUp>  . . . . . . . .  Move the box to the upper right-hand
  320.                                          corner of the screen.
  321.  
  322.           <Ctrl><PgDn>  . . . . . . . .  Move the box to the lower right-hand
  323.                                          corner of the screen.
  324.  
  325.           <PgUp>  . . . . . . . . . . .  Move box to top edge of the screen.
  326.  
  327.           <PgDn>  . . . . . . . . . . .  Move box to bottom edge of the screen.
  328.  
  329.           <Ctrl><Left Arrow>  . . . . .  Move box to left edge of the screen.
  330.  
  331.           <Ctrl><Right Arrow> . . . . .  Move box to right edge of the screen.
  332.  
  333.  
  334.  
  335.           GR2GIF /GR2PCX /GR2PIC  Documentation                      Page 7 of 7
  336.  
  337.  
  338.  
  339.           USING GR2GIF/PCX/PIC :  COMMAND LINE MODE
  340.           ------------------------------------------
  341.  
  342.           You can also run the conversion programs by placing both the input
  343.           (offspring) and output (GIF, PCX or PIC) filenames on the DOS command
  344.           line after the program name itself.  Use this example:
  345.  
  346.  
  347.           GR2GIF [d:][\path\]SCREENXX[.EXE] [d:][\path\][SCREENXX.GIF] [/S]
  348.  
  349.  
  350.           The parameters shown within [brackets] are optional.
  351.  
  352.           To use the resize option (described above) in command-line mode,
  353.           include the /S switch on the GR2GIF command line.  If you omit
  354.           the /S switch, the entire image will be converted to GIF format.
  355.  
  356.           The first [d:] stands for the disk drive where your offspring
  357.           program file is located, and the first [\path\] stands for the
  358.           directory in which it resides.  In the above example, SCREENXX.EXE
  359.           is the name of the GRABBER offspring file containing the image you
  360.           want to convert.  As above, ".EXE" extensions may be omitted.
  361.  
  362.           The second [d:] and [\path\] stand for the drive and directory in
  363.           which to place your converted output file.  If you omit the output
  364.           filename, the program will supply a default for you, and create your
  365.           GIF/PCX/PIC file on the same drive and directory as your input file,
  366.           giving it the same name as the input file but with a ".gif" (or ".pcx"
  367.           or ".pic") extension in place of the ".EXE".
  368.  
  369.           Another example.  Entering:
  370.  
  371.              GR2GIF C:\PICTURES\SCREEN00 /S
  372.  
  373.           has the same effect as entering:
  374.  
  375.              GR2GIF C:\PICTURES\SCREEN00.EXE C:\PICTURES\SCREEN00.GIF /S
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.                             **  End of CONVERT.DOC  **
  391.